package com.neusoft.yiyang.user.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class OpenApiConfig {

    /**
     * 配置用户服务模块的API文档元信息
     * 涵盖系统用户与角色的全生命周期管理
     */
    @Bean
    public OpenAPI userServiceOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("用户服务API")  // 明确标识模块为用户与角色管理服务
                        .description("包含系统用户的创建、查询、更新、删除，角色定义及用户-角色关联管理等接口，支撑系统权限体系的核心功能")  // 概括模块核心功能
                        .version("1.0")  // 接口版本，便于迭代管理
                );
    }
}